Summary

The Marketplace’s role is to link the Allocation to the Execution, giving the client the opportunity to buy and configure the BPaaS bundles received from the Allocation and to send the configured bundles to the Execution for provisioning.

CloudSocket Marketplace provides a collection of REST APIs in order in ensure connection and operability inside CloudSocket concept. CloudSocket is secured by YIDPB (Ymens Identity Provider Broker). YIDPB is build around four standards, OpenID Connect for authentication, OAuth2 and JWT for authorization and SCIM 2 for user profile.

Architecture design

Component diagram

Integration diagram

Environment

Development

CloudSocket Marketplace front-end

http://csmarket.ymens.com:8080

Production

N/A

Test Cases

API specification

Security API

url: http://csmarket.ymens.com:9090/oauth/token

Product API

url: http://csmarket.ymens.com:5050/api/product

authorization method: Header - OAuth2 authorization token

JSON sample

{
 "businessProcessSection" : {
   "businessProcess" : {
     "resourcePath" : "business-process/business-process.bpmn"
   },
   "image" : {
     "resourcePath" : "business-process/business-process.jpg"
   }
 },
 "deploymentSection" : {
   "deploymentPlan" : {
     "resourcePath" : "deployment.camel"
   }
 },
 "marketplaceSection" : {
   "businessDescription" : "This is a business description of the BPaaS Bundle.",
   "category" : {
     "name" : "Christmas Greetings",
     "parent" : {
       "name" : "Greetings"
     }
   },
   "icon" : {
     "resourcePath" : "images/icon.png"
   },
   "pictureList" : [ {
     "resourcePath" : "images/picture1.png"
   }, {
     "resourcePath" : "images/picture2.png"
   } ],
   "pricing" : {
     "formula" : "10",
     "frequency" : "MONTHLY",
     "currency" : "EURO",
     "description" : "This is the Pricing natural language description (e.g. 10€ per month)."
   },
   "seller" : {
     "organization" : "BrokerOrganization SRL",
     "name" : "Mario Rossi"
   },
   "serviceLevelAgreement" : {
     "description" : "This is the SLA natural language description."
   },
   "tagList" : [ "christmas", "xmas", "greetings" ],
   "technicalDescription" : "This is a technical description of the BPaaS Bundle.",
   "title" : "Christmas Card Greetings Bundle v1.0"
 },
 "workflowSection" : {
   "image" : {
     "resourcePath" : "workflow/workflow.jpg"
   },
   "workflow" : {
     "resourcePath" : "workflow/workflow.bpmn"
   }
 }
}

Category API

url: http://csmarket.ymens.com:5050/api/category

authorization method: Header - OAuth2 authorization token

JSON sample

{
   "name": "",
   "description": "",
   "parent": {}
}

Order API

url: http://csmarket.ymens.com:5050/api/order

authorization method: Header - OAuth2 authorization token

JSON sample

{
   "description": "...",
   "status":"PROCESSING/INSTALLED/FAILED",
   "createdDate":"",
   "completedDate":"",
   "customer":{}
}